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C PREFACE 


This publication is intended for the IBM programming service representative, installation programmer, and 

others involved in maintaining or using the SYS1.LOGREC data set. This publication does not replace 

the program listings; it supplements them and intends to make the information in them more accessible. 

This book describes: 

@ The internal logic and organization of the IFCDIPOO service aid program. 

@ The internal logic and organization of the system recording routines which build and write incident 
records on SYS1.LOGREC. 


° Contents 


This publication has three parts, preceded by a general Introduction and followed by an Index for the entire 
3 book. Each part has its own Table of Contents. 


The Contents Directory is a directory to the different parts of the publication. 
Part I: The Introduction describes the purpose and function of the SYS1.LOGREC data set and briefly tells 
how the SYS1.LOGREC data set is created, how routines write records on it, and how information is 


retrieved from it. 


Part II: Initializing SYS1.LOGREC (IFCDIP00) describes the logic and internal organization of the 
IFCDIPOO service aid program which initializes and re-allocates the SYS1.LOGREC data set. 


Part III: Recording Records on SYS1.LOGREC (System Recording Routines) describes the logic and 
internal organization of the system recording routines which build and write records on the SYS1.LOGREC 
data set. 

Organization 


This publication has three parts followed by an Index for the entire book. Each part has its own 
Table of Contents, and each part is divided into the following sections: 


@ Introduction — a description of the programs with some discussion of external characteristics. 
@ Method of Operation — a functional approach to the program using both diagrams and text. 


@ Program Organization — a description of program loading, module calling sequences, and the modules 
themselves. 


@ Directory — a cross-reference using module and label names in the source code and in the method of 
operation (MO) diagrams. 


@ Data Areas — a description of the major data areas used by the program modules. 


® Diagnostic Aids — information that can be useful for diagnosing errors in the programs. 
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How to Use This Publication 


Before using this publication, read the “Introduction” to understand the function and purpose of 
SYS1.LOGREC error recording. Then, read the Introduction to the part being referenced and scan the 
remaining sections of that part to become familiar with its contents. This should save time because the 
sections in each part provide, in addition to specific types of information, cross-references to the other 
sections in each part of the publication or to the program or microfiche listings. 


For example, in each part the Method of Operation section shows the program functions at a high (less 
detailed) level; therefore, some of the system recording functions are not shown. However, the Directory 

in each part lists the entry points and other module names for the modules whether or not they are included 
in the method of operation (MO) diagrams. 


Associated Publications 


e MVS/Extended Architecture JCL, GC28-1148 — describes how to use job control statements to 
override default parameters, use cataloged procedures, allocate space for data sets, code job control 
statements, and how to use JES2 control statements with other JCL statements. 


e MVS/Extended Architecture System Logic Library — describes the function and the logic of the 
channel check handler, dynamic device reconfiguration, the machine check handler, the missing 
interruption handler, recovery termination manager, and alternate CPU recovery. 


e MVS/Extended Architecture System Programming Library: SYS1.LOGREC Error Recording, GC28- 
1162 — describes how to use the IFCDIPOO service aid program and how records of different incidents 
are built and recorded on SYS1.LOGREC. 


e Environmental Recording Editing and Printing (EREP) Program, GC28-1178 — describes how to use 
EREP. 


e@ OS/VS Mass Storage System (MSS) System Data Analyzer, GC35-0027 — describes the ISDASDAO 
support for the IBM 3850 Mass Storage System. 


e MVS/Extended Architecture Message Library: System Messages, GC23-1156 — describes the 
system messages. 


e EREP Messages, GC28-1179 — describes the messages issued by EREP. 


e Debugging Handbook, LC28-1164 through 1168 — describes detailed format of the SDWA. 


e System Generation Reference, GC26-4009 — provides information for system programmers who are 
to plan for and install a Control Program and a JES2 Job Entry Subsystem. 
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Introduction 


The purpose of error recording on the SYS1.LOGREC data set is to provide a record of all 
hardware failures, selected software errors, and selected system conditions. Information 
about each incident is written onto SYS1.LOGREC by the system recording routines and 
can be retrieved by using EREP, The EREP output can be used for diagnostic and/or 
measurement purposes to support the system control program and maintain the devices 
that are part of a computer system. 


Error recording on SYS1.LOGREC, as shown in Figure I-1, involves: 
e Initialization of SYS1.LOGREC by the IFCDIPOO service aid. 


¢ Recording records of different incidents on SYS1.LOGREC. 
e Retrieval of the information on SYS1.LOGREC by using EREP. 


Initializing the SYS1.LOGREC Data Set 


The IFCDIPOO service aid initializes the SYS1.LOGREC data set on the system residence volume 
during system generation. IFCDIPOO creates a header record and a time stamp record for the 
SYS1.LOGREC data set and allocates space for the data set, which must reside on the 

system residence volume. I[FCDIPOO can also be used to re-allocate and reinitialize 
SYS1.LOGREC. 


After the first IPL or an engineering change, IFCDIPOO is used to place “frames” — editing 
instructions for MCH and CCH records — on SYS1.LOGREC. This process is only applicable 
on systems which have a Service Record File (7443-1 device type). 
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Figure I-1. SYS1.LOGREC Error Recording Overview 
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For information about how to use IFCDIPOO, see System Programming Library: 
SYS1.LOGREC Error Recording. For information about IFCDIPOO logic, see ‘‘Part II: Initializing 
SYS1.LOGREC (IFCDIPOO)” of this publication. 


Recording Records on SYS1.LOGREC 


Eleven types of records, containing device-or incident-dependent information, can be recorded on 
SYS1.LOGREC: 


e@ CRW records for channel path, subchannel, and monitoring facility errors. 


@ DDR records for information describing operator and system swaps between direct access and mag- 
netic tape devices and for operator swaps on unit record devices. 


@ EOD records for information related to end-of-day conditions whenever the RDE option has been 
included in the system. 


e IPL records for information related to system initializations whenever the RDE option has been 
included in the system. 


e MCH records for CPU, storage, storage key, and timer failures. 


e MDR records for buffer overflow and device failures on buffered log devices, for demounts on direct 
access devices with buffered logs, for demounts by the DFDSS program product between direct access 
devices having buffered logs and removable disk packs, for device failures on teleprocessing devices 
connected to an IBM 3704 or 3705 device, and for statistical recording by EREP on direct access 
devices with buffered logs. 


e MIH records for information describing missing interruption of all devices except the teleprocessing 
devices. 

@ OBR records for counter overflow statistics and device failures on devices supported by the tele- 
processing access methods, for end-of-day requests, for paging I/O errors, for permanent channel 
and I/O device failures, for statistic counter overflow, for temporary or intermittent I/O device 
failures, for demounts on the IBM 3420 type magnetic tape devices, and for statistical recording 
by EREP on direct access devices with in-core counters. 


e SLH records for subchannel failures. 


@ SOFTWARE records for software detected software errors such as routines affected by programs issuing 
the CALLRTM or ABEND (SVC 13) macros, for hardware detected software errors such as. program 
checks, for operator detected errors such as pressing the restart key, and for hardware detected hard- 
ware errors such as software recovery attempts for hard machine failures. 


@ TIME STAMP record for measuring approximate time interval between termination and re-initialization 
of the operating system. 


Each record on SYS1.LOGREC contains complete and specific information for the device, type of 

failure or system condition that caused it to be written. For complete information about the system 
recording routines and the RDE option, see System Programming Library: SYS1.LOGREC Error 
Recording. For information about the logic of the routines which format and write the various records on 
SYS1.LOGREC, see “Part III: Recording Records on SYS1.LOGREC (System Recording Routines)” 

of this publication. 
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Retrieving Information on SYS1.LOGREC 


The Environmental Recording Editing and Printing (EREP) program enables you to examine 
the data recorded on SYS1.LOGREC and/or Accumulation data sets in the forms of system overview 
reports, edited records and record summaries. 


EREP can perform the following functions: 


e@ Create an Accumulation data set from the SYS1.LOGREC data set and clear SYS1.LOGREC. 
Copy an Input Accumulation data set to an Output Accumulation data set. 

Merge data from an Accumulation data set and SYS1.LOGREC. 

Print a detailed description of the hardware and software error records. 

Summarize and print statistics for device failures. 


See Environmental Recording Editing and Printing (EREP) Program for information on using 
EREP. 
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Introduction 


The disk initialization program (IFCDIP00), controlled by job control language statements, runs as a 
problem program under MVS/XA, and has three applications: 


e During system generation to initialize the SYS1.LOGREC data set. Initializing SYS1 .LOGREC 
creates a header record, a time stamp record, and allocates space for the data set on the system 
residence volume. See System Programming Library: System Generation Reference 
for a discussion of this application. 


e Asaservice aid to reinitialize the SYS1.LOGREC data set. The SYS1.LOGREC header record 
is destroyed if an uncorrectable channel error occurs while EREP or a SYS1.LOGREC recording 
routine is rewriting the header record onto the SYS1.LOGREC data set. Use IFCDIPO0 to 
reinitialize the data set. 

e Asa service aid to modify the space allocation for the SYS1.LOGREC data set. If you need to 
change the size of the SYS1.LOGREC data set, created by the system generation process, use 
IFCDIPOO to increase or decrease the space allocation for SYS1.LOGREC. 


The system generation process selects the IFCDIPOO module and puts it in the system’s link library 
(SYS1.LINKLIB). IFCDIPOO is a standard service aid program of the system control program. 
For a complete description of how to run IFCDIPOO, see System Programming Library: 
SYS1.LOGREC Error Recording. 
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Method of Operation 


The Method of Operation section contains a method of operation (MO) diagram that shows the function 
of IFCDIPOO and is also a guide to the program listing. To do this effectively, the MO diagram is shown 
at a high (less detailed) level; thus, some functions of the IFCDIPOO routine are not shown. Use the 
directory and program organization sections for this part of the publication to find any module 
information and labels in the program listing for this routine that are not included in the MO diagram 

in this section. 


DIPOO Diagram 1 shows the function of the IFCDIPOO program. 


Key to Operation Diagrams 
Entry from source external to See referenced diagram 
recording routines for details 
Flow of control passes to 
Control flow referenced diagram 


Data transfer Reference to 


Pointer to address of ! Brackets denote related items 


Look for correspondingly lettered Look to corresponding number in 
blow-up on same page text 
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DIPOO Diagram 1. Function of the IFCDIPOO Program (Part 2 of 2) 
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Program Organization 


The Program Organization section describes the program organization (object module) of the IFCDIPOO 
service aid. [t contains the following information: 


® Module description — which describes the logic of the IFCDIPOO module. 


The module description provides a direct reference to the module directory in this part of the publication 
and to the object module name in the program listing. 
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Module Description 


IFCDIP00 — SYS1.LOGREC Initialization Module 


Entry From: Control program to entry point IFCDIPOO. 
Registers at Entry: REG1 points to address of address of PARAMETER Field. 


Operation: The SYS1.LOGREC data set is enqueued. The SYS1.LOGREC data set is opened and 
the data is located in the Device Table (DEVTAB) entry associated with system residence volume. 
Information about the SYS1.LOGREC data set is obtained, which is on the system residence volume, 
for the SYS1. LOGREC header from the following areas: 


@ Device code from DCB + 17. 
@ Device information from DEVTAB. 
e Allocation information from DEB. 


The low extent address is used to compute the beginning of the record entry area, located following the 
header and time stamp records. The 90% full point of the data set is calculated. BSAM is used to write 
the header and the time stamp place holder to the SYS1. LOGREC data set. 


All error messages are issued to the system console via the WTO macro. At the end of the job, 
SYS1.LOGREC is closed and a WTO is issued to signal completion. The following return codes are 
issued in REGIS: 


1. O = Successful completion. 


2. 16 = SYS1.LOGREC has not been initialized. 
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Data Areas Defined: 
1. SYS1.LOGREC header. 
2. Dummy Time Stamp Record. 
3. | Communications vector table overlay. 
Data Areas Referenced: DEVTAB, CVT. 
Data Areas Updated: None. 
Routines Called: None. 
Macros Used: 
1. EXCP -—Retrieve CPU serial number. 


2. READ —Read the partially built record header. 

3. WRITE —Write via BSAM to SYS1.LOGREC. 

4. OPEN —Open SYS1.LOGREC 

5. CLOSE W—Close SYS1.LOGREC 

6. TIME -—Retrieve date and time for inclusion in header portion of the time stamp. 
7. ENQ —Make SYS1.LOGREC unavailable to other users. 

8. DEQ  —Make SYS1.LOGREC available to other users. 


9. MODESET  -—Enter supervisor state to issue STIDP. 
Size: 8828 bytes 
Exit: To the control program with return code in register 15. 
Registers at Exit: 


R 14 —— Return address. 
R 15 —— Return codes: 


0 = Successful completion. 
16 = SYS1. LOGREC has not been initialized. 
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Directory 


The Directory section provides the cross-reference lists necessary to quickly identify important names 
in the program listings and in the other sections of this part of the publication. 


This section contains the module directory — a list of different names for the IFCDIPOO module. The 
list contains: 


@ The distribution library (DLIB) or microfiche (fiche) name. 
@ The module name and module name alias(es) in SYS1.LINKLIB. 
e A brief description of the function of each module. 


@ The CSECT, entry point, and load module names. 
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Module Directory 


DLIB/ Entry Load CSECT SYS1.LINKLIB 
Fiche Point Module Name Alias Function 
IFCDIPOO START IFCDIPOO IFCDIPOO IFCDIPOO SYS1.LOGREC 


initialization module, 
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C Data Areas 


The Data Areas section provides information about the IFCDIPOO data areas. The information in the 
data areas can assist in interpreting storage dumps and in determining the program and system status 
at the time of a failure. 


Consult System Programming Library: SYS1.LOGREC Error Recording for the detailed format 
of the major IFCDIPOO data areas that are listed in this section. 


This section provides information about the following major data areas that are defined by the 
IFCDIPOO module: 


@e SYS1.LOGREC Header Record. 


e@ Time Stamp Record. 
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SYS1.LOGREC Header Record 
Acronym: None. 
Full Common Name: SYS1.LOGREC Header Record. 
Macro ID: None. 
MO Diagrams: 1. 
Created by: IFCDIPOO. 
Referenced by: IFCIOHND, IGCOQOQO7F or IGFPEMER. 
Updated by: [FCIOHND, IGCO007F or IGFPEMER. 
Size: 40 bytes. 


Pointed to by: Located as first record on SYS1.LOGREC data set as follows: CVT address + 
X‘75’ = t SYS1.LOGREC DCB; DCBDEBAD = ft DEB. (DEB contains extents of SYS1. LOGREC 
data set on system residence volume.) 


Function: 


@ Used by IGCO007F and IGFPEMER to determine where to write new record entries on 
SYS1.LOGREC. 


@ Used by IFCIOHND to retrieve information from existing record entries on SYS1.LOGREC. 
@ Used by IGCO007F to determine when to issue a warning message that the SYS1.LOGREC data 
set is 90% full. 
Time Stamp Record 
Acronym: None. 
Full Common Name: Time Stamp Record. 
Macro ID: None. 
MO Diagrams: 1. 
Created by: IFCDIPOO. 
Referenced by: IGCQ007F (SVC 76). 
Updated by: IGCO00O7F. 
Size: 40 bytes. 


Pointed to by: Record immediately following SYS1.LOGREC header record on SYS1.LOGREC 
data set. 


Function: Contains time and date information for the IPL record. This information allows the user 
to measure the approximate time interval, recorded in the IPL record, between the termination and 
reinitialization of the operating system. 
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Diagnostic Aids 


The Diagnostic Aids section provides cross-references between the diagnostic information in this section 
to the related sections in this part of the publication and to the program or microfiche listings. 


This section contains the following lists of information about the IFCDIPOO module: 


@ Messages — a summary of the messages, their message IDs, and the issuing module. 


@ Return codes — a summary of the return codes, their meanings, and the related MO diagram. All 
return codes are in register 15. 


@ System completion codes — IFCDIPOO does not issue any system completion codes. (No list 
provided.) 


@ Wait state codes — IFCDIPOO does not issue any wait state codes. (No list provided.) 
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IFCDIPOO Messages 


Consult the following publication for explanations, system actions, and appropriate programmer 
responses to IFCDIPOO messages: 


Message Library: System Messages. 
All message texts are in module [FCDIPOO. 


Issuing 

Message ID Message Text Module 
IFCOO1! D=devtyp N=X F=trcek L=trck S =recd IFCDIPOO 

DIP COMPLETE 
|FCOO2! SYS1.LOGREC CANNOT BE OPENED IFCDIPOO 
1FCOO31 SYS.1LOGREC HEADER WRITE ERROR IFCDIPOO 
IFCOOS9I INVALID SYSRES DEVICE {\FCDIPOO 
1FC1561 INVALID PARM FIELD IFCDIPOO 
1FC1571 VERBAGE FAILURE IFCDIPOO 

IFCDIPOO Return Codes 

Return 

Code 
Module (Hex) Meaning MO (s) 
IFCDIPOO 00 Normal exit to control program 1 

16 SYS1.LOGREC not initialized 1 
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i Introduction 


Records are recorded on SYS!.LOGREC for every hardware or software failure and system condition that 
has an associated recording request or recording routine. The records can contain two types of data that 
document failures and system conditions: 


e@ Error statistics — counts of the number of times that channels, machine models, and I/O devices have 
failed. 


e@ Environmental data — time and circumstances for each failure or system condition. 
The records are recorded on SYS!.LOGREC as undefined length records. In general, each record contains: 


Relevant system information at the time of the failure. 
Device hardware status at the time of the failure. 
Results of any device/control unit recovery attempt. 
Results of any software system recovery attempt. 
Statistical data. 


The system generation process selects the recording modules and puts them in the appropriate system 
library. See the module directory in this part of the publication for a list with each module in its appro- 
priate system library. 
The recording routines are standard programs of the system control program. For a complete 
description of how records are built and recorded on SYS1.LOGREC, see System Programming 
‘ Library: SYS1.LOGREC Error Recording. 
Types of Records on SYS1.LOGREC 


The SYS1.LOGREC data set, a non-sharable system data set, is a permanent data set that resides on the 
system residence volume. The SYS1.LOGREC data set contains: 


@ A header record. 
@ A time stamp record. 


@ Environment record(s) for each failure and system condition that has an associated recording 
routine. 


@ Statistical records that contain counts of the number of times devices have failed. 
Recording Figure III-1 shows the system recording routines that format and write each type of record on 


SYS1.LOGREC. Recording Figure [II-2 lists the incidents and the types of records that can be recorded 
on SYS!1.LOGREC for each incident. 
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e EOD Command 
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Device Failure 
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e Statistical Counter Overflow Formats: 
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e Buffer Overflow 


e Device Failures 
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Notes: 


1. Buffered log devices -- devices attached toa 
control unit with o buffer for recording or 
logging device-dependent, status and sense 
information, 


* Routines or modules documented 
in SYS1.LOGREC Logic Manual. 


from Part 2 2. Temporary failures -- device-dependent, 
intermittent failures defined by the ERP to 
be recorded on SYST.LOGREC. 


Recording Figure III-1. Writing Records Onto SYS1.LOGREC (Part 1 of 2) 
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Recording Figure III-1. Writing Records Onto SYS1.LOGREC (Part 2 of 2) 
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Record types 
OBR, | OBR, | Soft- 
Incidents CRW Long Short | ware 


[Timer Fite | La 
Vary Offline ae a 


Numbers in boxes (reading horizontally) indicate: 


e That a specific record type is created for the incident. 


@ The approximate chronological creation of the record types, if required, on SYS1.LOGREC. 


For example, a permanent channel control check incident generates SLH records (Note A) before generating a long OBR record 
(Note B). 


* Asterisk denotes mutually exclusive, device-dependent records. For example, an EQV request on an IBM 3420 magnetic 
tape device generates a long OBR record (Note D). The MDR record is ignored (Note E). 


Letters in boxes indicate the following: 


A. Created one SLH record if buffer space is available. Otherwise, no record is built. Also, more than one record can describe 
the same incident before it becomes permanent (uncorrectable). 


. Created only if condition is permanent (uncorrectable). 


. Created only for devices with a buffered log and removable disk packs (such as the |BM 3330, 3340, and 3850). 


. Created only for the IBM 3420 magnetic tape devices. For EOD command, created randomly and can 
precede short OBR records or follow MDR records. 


. Created only for devices with buffered logs (such as the IBM 2305, 3330, 3340, 3350, 3375, 3380, and 3850). For 
EOD command, created randomly and can precede or follow short and long OBR records. 


. Not created for teleprocessing devices other than the local 3704/3705 and 3791. 


. Created only for those devices having an ERP that records certain intermittent or permanent incidents. (Such as the ERPs 
for the IBM 2305, 3330, 3340, 3350, 3375, 3380, and 3850.) 


. Created randomly; MDR and long OBR records can precede short OBR records. 


Created only for hard machine failures which indicate recording on SYS1.LOGREC. 





Figure III-2. Incident/Record Table (Part 2 of 2) 
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Method of Operation 


The Method of Operation section contains method of operation (MO) diagrams that show the functions 

for recording record entries on SYS1.LOGREC and are also a guide to the program listings. To do this 
effectively, the MO diagrams are at a high (less detailed) level; thus, some functions of the system recording 
routines are not shown. Use the directory and program organization sections for this part of the publication 
to find the modules and labels in the program listings for any routines that are not shown in the MO 
diagrams in this section. 


Recording Figure III-3 provides an overview which shows the symbols used in the MO diagrams and the 
following functions of SYS1.LOGREC record entry recording: 


Diagram 1: SYS1.LOGREC record entry recording overview — which shows what type of record entry 
is created for certain conditions. 


Diagram 2: |OBR/MDR recording — which shows the recording functions of the OBR/MDR recorder 
(IGEQO25F). 


Diagam 2.1: OBR/MDR recording (new interface) — which shows the recording functions for new 
interface (IGEO125F). 


Diagram 3: SVC 76 recording — which shows the recording functions of SVC 76 (IGCO007F). 
Diagram 3.1: SVC 76 recording (NDPA Processing) — which shows the recording functions of NPDA. 
Diagram 4: SVC 91 recording — which shows the recording functions of SVC 91 (IGCO009A). 


See System Logic Library for a detailed description of the channel check handler, dynamic 
device reconfiguration, the machine check handler, and the missing interruption handler. 


Method of Operation III-9 
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Recording Diagram 1. SYS1.LOGREC Record Entry Recording Overview (Part 1 of 4) 
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Recording Diagram 1.SYS1.LOGREC Record Entry Recording Overview (Part 2 of 4) 


Explanation Explanation 


1 A channel failure causes an SLH record to be built by the subchannel logout 6 A non-critical hardware failure (CPU or processor, storage, storage key or 
handler (SLH). After formatting the record, SLH invokes the recording request timer failure), corrected by either the hardware or software recovery 
routine (IEAVTRET) which queues the record on the asynchronous Output routines, causes the machine check handler (MCH) to build a MCH record 
queue and posts the asynchronous recording task (IEAVTRET) to write records and pass control to the recovery termination manager (RTM). RTM invokes 
on SYS1.LOGREC. Control returns to the control program. the recording request routine (IEAVTRER) which queues the record on the 

asynchronous Output queue and posts the asynchronous recording task 
The hardware generates a channel report word (CRW) to describe a machine (IEAVTRET) to write records on SYS1.LOGREC. Control returns to the 
malfunction affecting one or more channel subsystem facilities. The software control program. 
generates a CRW to simulate a machine malfunction affecting one or more 
channel subsystem facilities. The CRW processor formats the CRW into a A critical hardware failure (one that causes processor termination), not 
CRW record and writes that record on SYS1.LOGREC. corrected by either the hardware or software recovery routine, causes MCH 
to build a MCH record and invoke the MCH emergency recorder (IGFPEMER). 
The DDR recorder (IGFDRO) uses DDR swap information to build DDR records IGFPEMER writes this record on SYS1.LOGREC and also attempts to 
which describe system or operator initiated swaps on direct access or magnetic write any records for SYS1.LOGREC on the asynchronous output queue 
tape devices and which describe operator initiated swaps on unit record devices. onto SYS1.LOGREC before passing control to IGFPTSIG, IGFPTSIG 
IGF DRO creates a record describing each device involved in the swap unless it then places the system in a disabled wait state. 
detects an error condition or offline status. After formatting the record, |GFDRO 
invokes the recording request routine (IEAVTRER) which queues the record on 
the asynchronous output queue and posts the asynchronous recording task 
(IEAVTRET) to write records on SYS1.LOGREC. 


The master scheduler invokes the DDR recorder (IGFDRO) to issue SVC 76 
(1GC0007F) with register 0 containing a zero to indicate EOD record processing. 
SVC 76 builds the record by adding date and time values to the other standard 
record header information and then writes the record on SYS1.LOGREC. Control 
returns to the master scheduler. 


As part of the initialization, |OSROUTG issues SVC 76 with register 0 containing 
an eight to indicate IPL record processing. SVC 76 formats the IPL record by 
adding: 


Environmental and statistical information to the standard record header. 
Date and time values from the SYS1.LOGREC time stamp record. 


An IPL reason code and a subsystem |D code from a WTOR message if the RDE 
option is in the system. 


After formatting the record, SVC 76 writes the record on SYS1.LOG REC and 
returns control to |OSROUTG. 





Figure III-2. Incident/Record Table (Part 1 of 2) 
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Recording Diagram 1. SYS1.LOGREC Record Entry Recording Overview (Part 3 of 4) 
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Recording Diagram I. SYS1.LOGREC Record Entry Recording Overview (Part 4 of 4) 


Explanation Explanation 


7 A device failure or buffer overflow on a buffered log device causes a device dependent which queues the record on the asynchronous Output queue and posts 
error recovery procedure (ERP) to store error data in that device's record buffer. The the asynchronous recording task (IEAVTRET) to write records on 
OBR/MDR recorder (I|GEOO25F) formats that data into an MDR record and invokes SYS1.LOGREC. Then, IGEOQO25F scans the asynchronous OBR queue, 
the recording request routine (IEAVTRER) which queues the record on the asynchron- contructs an OBR record for each queued paging |/O error, and invokes 
ous Output queue and posts the asynchronous recording task (IEAVTRET) to write IEAVTRER again. 


records on SYS1.LOGREC. Control returns to the control program or to the XCTL 


routine (IECXTLER). SVC 76 (1GC0O007F), when invoked by the master schedule for EOD 


processing (operator issuing a HALT EOD command), searches the 


A device failure or buffer overflow on an IBM 3704 or 3705 buffered device or a counters in the device statistics table. For each counter with a non- 
device failure on a TP device connected to an IBM 3704 or 3705 device causes the zero value, SVC 76 builds OBR record, For each IBM 3420 type tape 
device-dependent ERP to either store the data in the device's record buffer or trans- device, SVC 76 issues SVC 91 to build a record describing that device’s 
fer the error information to VTAM (virtual telecommunications access method). statistical information. SVC 91 issues SVC 76 to write the OBR record 
When the VTAM MDR recorder (ITTSCMR) receives control, it adds environmental on SYS1,.LOGREC, (No OBR records are built for buffered !og de- 
and statistical information to that data to format an MDR record and invokes the vices such as the IBM 2305, 3340, and 3850 devices. An MDR record 
recording request routine (IEAVTRER). This routine queues the record on the built by SVC 91, describes the statistical information for those devices 
asynchronous Output queue and posts the asynchronous recording task (IEAVTRET) to during EOD processing.) Control! returns to the master scheduler. 


write records on SYS1.LOGREC. Control returns to the calling routine. 
SVC 91 when invoked by other demounts (CLOSE/EOV requests, 


Demounts (CLOSE/EOV requests, DDR swaps, deallocation conditions, and EOD deallocation conditions, and DDR swaps) for the IBM 3420 type tape de- 
command) involving buffered log DASD and demounts by the DFDSS program proa-: vices, also creates an OBR record to describe that event. 


uct on buffered log DASD with removeable disk packs invoke SVC 91 (IGCOOO9A), 
SVC 91 determines that recording is for a buffered log DASD, formats the sense 
data from the device’s record buffer into an MDR record, and issues SVC 76 to 
write the record on SYS1.LOGREC. Control returns to the calling routine. 


10 The operating system uses functional recovery routines (F RRs) and 
ESTAE/ESTAI services to attempt recovery and record software 
records for the following conditions: 


e Hardware detected hardware errors such as recovery attempts for hard 





8 The MIH recorder (IOSRMIHL) uses MIH information which describes missing machine failures. 
interrupts to build an MIH record. |OSRMIHL creates a record for each missing 
interrupt and invokes the recording request routine (IEAVTRER). IEAVTRER 3 Hardware detected software errors such as program checks. 


Queues the record on the asynchronous output queue and posts the asynchronous 
recording task (IEAVTRET) to write records on SYS1.LOGREC. Control returns 
to the calling routine. 


e Operator detected errors such as pressing the restart key. 


e Software detected software errors such as ABTERM (CALLRTM 


Q The OBR/MDR recorder (IGEQO25F/IGE0125F) builds OBR records to describe macro) or programs issuing an invalid SVC. 

the following conditions: 
F RRs provide recovery for locked, SRB (service request block), and 
supervisor control mode functions. ESTAE/ESTAI services provide 


® Paging I/O errors. 


° Permanent (uncorrectable or unit check) channel and device failures. recovery for enabled, non-locked task mode functions. 
e Statistical counter values. For error recording purposes, FRR and ESTAE/ESTAI services collect 
error data in the system diagnostic work area (SDWA) to assist the FRR 
© Temporary or intermittent I/O device failures, or ESTAE/ESTAI service in identifying the SCP error. If indicated, they 
invoke RTM to format a software record. RTM formats the record using 
e Path failures handled by alternate path recovery. standard record header information, the SDWA information, and variable 
information supplied by the FRR or ESTAE/ESTAI services. RTM then 
{GE0025F, when invoked by a device-dependent ERP or the statistics update routine invokes the recording request routine (IEAVTRER) which queues the 
(1GE0025D), obtains environmental and/or statistical data about the failure or counter record on the asynchronous output queue and posts the asynchronous 
overflow condition and constructs an OBR record. After formatting the record, recording task (IEAVTRET) to write records on SYS1.LOGREC. 


1GEOO25F invokes the recording request routine (IEAVTRER) 
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Recording Diagram 2. OBR/MDR Recording (Part 1 of 2) 
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Buffer 





For Recording 
Facility 
Processing 






Register O 


Register | 








4 Formats OBR record, 


A 
11) EWA Register 5 
Switches Statistics 


UCB 
1 (1) Switches 


Register 5 





Checks asynchronous 
OBR queue for 
paging I/O errors. 


YES NO 


@ Path failures which may cause 
lackout on other paths 
|OSB 
0 (0) 1/O Switches 
4 ucB 
A EWA 
e Statistic counter overflow or 
temporary I/O device failure: 
EW 7 


A 1O§$ Communication Area 





Register 6 


A ERP/WTO Queue 














IEAVETRER 


For 
Recording 


Facility 
Processing 


Exits To: 
Supervisor 
or 


IECXTLER 
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Recording Diagram 2. OBR/MDR Recording (Part 


CSECT 




























A device-dependent ERP or the statistics update routine 
(IGE0025D), via the I/O supervisor, invokes the OBR/MDR 
recorder (1GE0025F) to perform either MDR or OBR recording: 


e MDR recording — builds an MDR record to describe: buffer 
overflow or device failures on buffered log devices. 


e@ OBR recording — builds an MDR record to describe: paging 
|/O errors, permanent (uncorrectable or unit check) channel! 
and device failures, statistical counter values or temporary 
(intermittent) I/O device failures, path failures handled by 
alternate path recovery. 





1 Register | points to the IOSB. Puts EWA address from the 
IOSB in register 1, UCB address from the IOSB in register 
4, and the IOSB address in register 12, 


Checks EWA switch, offset 1, whether entry is for MDR 
recording: 


e Yes — MDR processing continues, See step 3. 
e@ No — OBR processing begins, See step 4. 


2 Tests UCB to determine which buffered log device has data 
for an MDR record, Places device's record buffer address 
in register 8, 


3 Obtains formatted record from device's buffered log. 


If record is not formatted in the device's buffer, such as 
for the IBM 3270 (BTAM-supported) devices, 
formats record in GETMAIN area, 


Initializes the record header with system environmental 
information. 


Puts record size in register O and record address in register i 
before invoking the recording request routine (IEAVTRER). 
This routine, part of the recording facility, queves the 
record on the asynchronous output queue and posts the 
asynchronous recording task (IEAVTRET) to write the 

records on this queve on SYS1,LOGREC., 


Returns to supervisor when value in register 13 is zero, 
or 

Returns to DDR if error is permanent and DDR is in system 

or to TCAM ERP for TCAM EOD condition by loading 

binary equivalent of module name into register 13 and 


branching to XCTL routine IECXTLER, 


4 = Formats OBR record according to type of incident: 


@ TP device: 


Checks UCBETI field, offset 0, of UCB extension for 
record describing incident on teleprocessing device. 


2 of 2) 


|GEO025F | IGEOO25F 


OBRSTART 


MDR 


NOTFORM 


INITHDR 


SETIME 


NOMAIN 


EXIT | 


LABL2 


Cr | 





Explanation 


Tests EWA switch, offset 42, for EOD or counter 
overflow to be made for a TP device. 


Completes short OBR record for TTAM/VTAM EOD 


or counter overflow condition. 


Builds long OBR record with environmental and statis- 
tical information to describe device failure ona 

TP device, 

Puts record size in register 0 and record address in regi- 
ster 1 to setup record for recording on SYS|.LOGREC. 
Permanent channel or device failure: 


Tests IOSB switch, offset 0, for permanent error. 
Builds long OBR record to describe incident. 


Puts record size in register 0 and record address in regi- 
ster | to setup record for recording on SYS].LOGREC. 


Statistic counter overflow or temporary I/O device 
failure: 


After building record header, adds statistical informa~ 
tion from device's entry in the statistics table, (Short 
OBR record for devices without variable length entries; 
long OBR record for those with variable length entries.) 


Moves sense information from EWA for long OBR record, 


Puts record size in register 0 and record address in regi- 
ster | to setup record for recording on SYS].LOGREC, 


Invokes recording request routine, part of the recording 
facility, which queues the record on the asynchronous 
output queue and posts the asynchronous recording task to 
write the records on this queue on SYST,LOGREC, 


Checks ERP/WTO queue, offset 4, for [OSB address, If 
located, the DASD ERP (IECVDERP) has queved an IOSB 
and an associated EWA describing a paging I/O error on 
the asynchronous OBR queue. 


Formats long OBR record for each queued paging I/O error 
using 1OSB and EWA information, 


Adds environmental and statistical information and sets up 
record for recording on SYS1,LOGREC as in step 4 for 
permanent channel or device failure, 


Returns to supervisor when value in register 13 is zero, 
or 

Loads binary equivalent of module name into register 13 

and branches to XCTL routine IECXTLER, 





C 


TCREC 
ATCMREC 


TAMOFL 


FULLREC 


WRTTCAM 


TSTPERM 


FULLREC 


SVCPRE 
SETADR 


LOOP2 
NEWSTAT 


SENSE 


NEWSTAT3 
SETADR 


DIRCHK 


DIRENTRY 


FULLREC 
SVCPRE 


EXIT3 


EXIT] 


ZR61 “dIOD WAI WUSAdOQS O-LETI-SZAT “WAI JO S[eloyew poyorsysar suteyuoo yuaWINdOp sy, 


wBo'y BuUIpIo.ey JOY DAWOOT ISAS SI-Ill 


REGISTER 1 
= f 1OSB 


t RCT, EWA, 
UCB 


Buffer supplied in 
user build area. 


Data supplied by 
caller: REQD: 
Failing CCW, CSW, 
dev. dep. data 
sense bytes, 


SDR counters. 
OPTIONAL: 

(long) device number, 
(short) number of 
SDR counters, 
device number. 





Recording Diagram 2.1 OBR/MDR Recording (New Interface) (Part 1 of 2) 


Process Output 










BUILDS AND RECORDS OBR & MDR 
RECORDS 





Determines type of 
record. 


Register 0 = 
record size 















Register 1 = - 


Builds OBR 
: record address 


record 
















Frees user build 
area, if requested 










5 Determines if any 
more RCT’s are on 
the chain. 


NO 







6 Exits to DDR or Register 13 = 


XCTL routine if bj 

req liesed eles a ee inary equivalent 
j : of module name 
exits to supervisor 
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Recording Diagram 2.1. OBR/MDR Recording (New Interface) (Part 2 of 2) 


The old OBR/MDR recorder (1\GEOQ025F) 
invokes |GEO125F when use of the new 
interface is detected (EWARCBLT). 


e@ OBR-Builds an OBR record to 
describe: paging !/O errors, 
permanent channel and device 
failures, stat counter values, and 
temporary device failures. 


e MDR-Builds an MDR record to 
describe: buffer overflow or de- 
vice failures on buffered log 
devices. 











































Register 1 points to the |OSB. 
pointers to the EWA, RCT, and UCB 
may be obtained from there. 


Does a GETMAIN for a build area. 
If it fails, OBR/MDR terminates. 
Otherwise it checks EWA flag byte 

2 (EWA +5) to determine whether an 
OBR or an MDR record is to be 
constructed. 


e@ MOR - see (2) 
e OBR - see (3) 


Formats MOR record by filling in the 
header with system data and getting 
class/source, record dependent flags, 
and the device buffer from the 
caller. Records record and indicates 
success status. Proceeds to step 4. 


3 Checks RCT flag byte 1 to decide 

if a short record is to be made. 

e SHORT - formats short OBR 
record by getting the device 
number and count of SDR 
counters from the UCB or 
optionally from the caller. 


1GEO125F [GEO125F 












YESGET 








OBRHDR 









SHORTOBR 





®e LONG — formats long OBR 
record by getting the device 
number as for short. 


LONGOBR 









Frees user build area if so requested FREEBLDA 


(RCTRECGO and RCTRECFR). 


If any more RCT's are on the chain 
{RCTRECNX) then return to (1) - 
YESGET. 








[GE0125F 


6 If DDR or XCTL exit was requested 
{RCTRECDR or RCTXCTLX) then 
take the appropriate exit, otherwise 
exit to the supervisor via SVC 3. 
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Recording Diagram 3. SVC 76 Recording (Part 1 of 2) 
From: 
Calling 
Input Routine Processing Output 





SVC 76 Record Processing 









Register O 


Value 


UCB 
Information 
Device 
Statistics Table 
System Generation Option 


CTRLPROG OPTIONS =(..., RDE,... 






‘| Tests value in register 0: 











0 4 8 = 12(x‘0C') 


Negative (-) 8 
GoTo GoTo 












Step 3 Step4 






2 EOD or EREP processing- 
formats following records: 


a) Short ORR records for EOD 
statistics. 










Long OBR records for IBM 
3420 type devices. 






MDR records for buffered 
log device. 


d) EOD record (EOD 
processing only). 








For SVC 91 
Processing 







Formats IPL record. 










(RDE Option 
Present) 











Adds date and time values to 
SYS1.LOGREC time stamp 
record. 





Register 0 


Two's 
Complement 
Record Size 


Register 1 


6 Writes record on SYS1.LOGREC. Se ) 


Exits To: 
Calling 





routine 


Register O 


















Two’s Complement 
Record Size 
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Register 1 


Header Record 


Time Stamp Record 


Record Entries: 


SLH e 
DDR ® 
EOD e 
IPL e 
Software ® 
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Recording Diagram 3. SVC 76 Recording (Part 2 of 2) 


Explanation [Module | CSECT seater ___wesse CSECT 


IZ] uoeradg jo powyay 











SVC 76 performs the following functions. 


@ Writes a formatted record on SYS1.LOGREC 
data set. 

@ Performs EOD record processing during 
system termination. 

e Formats an IPL record during system 
initialization, 

@ Adds date and time values to SYS1.LOGREC 

time stamp record for later use in IPL 

records. 
















Tests register O to identify the function to 
be performed 


Value Meaning 
negative Caller has a formatted record to be 


SYS1.LOGREC time stamp 
record. 





2  EODor EREP record processing, 

based on UCB information for each 
device in system, formats the following 
records. (Loops through device statistics table 
to obtain statistical counter information.) 




















a. Formats short OBR records. Resets 
counters to zero. Puts record size in two's 
complement in register O and record 
address in register 1 to have record 
written on SYS1.LOGREC (see step 5). 

b. Issues SVC 91 for each online IBM 3420 
tape device to format a long OBR record. 
SVC 91 issues SVC 76 to write the record 
on SYS1.LOGREC (see step 5) and returns 
to EOD or EREP record processing. 

c. Issues SVC 91 for each online buffered log 
device to format an MDR record. SVC 91 
issues SVC 76 to write the record on 
SYS1.LOGREC (see step 5) and returns 

to EOD or EREP record processing. 





When device statistics table has been searched 
and EOD record processing is being done, 
formats an EOD record. 


1\GCOQ007F | |GCO007F 


WRTREC 


STGAVAIL 


STATLKUP 


NEWSTAT 
RECSET 


ISNEWDEV 


Formats EOD record from system environ- 
mental information. 


Puts record size in two’s complement in 
register 0 and record address in register 1 to 
have record written on SYS1.LOGREC (see 
step 5). 


3 Formats IPL record. Obtains date and time 
values from SYS1.LOGREC time stamp 
record. 


Issues BLDL to check system for RDE option: 


e If present, issues WTOR messaye and adds 
IPL reason and subsystem ID code information 
from WTOR to corresponding fields in IPL 
record. 
If not present, adds default values to IPL 


SYS1.LOGREC (see step 5) by putting record 
size in two's complement in register 0 and record 
address in register 1. 


4 Obtains date and time values to add to 

SYS1.LOGREC time stamp record. Prepares 
to have record written (see step 5) by putting 
two's complement of record size in register O and 
record address in register 1. 


5 sift register O is negative, go to NPDA pro- 
cessing (MO 3.1). 


G Makes negative value in register 0 positive 
to obtain record size of record to be written 

on SYS1.LOGREC. 

Issues ENQUEUE instruction to serialize 

SYS1.LOGREC. 

Writes record, using EXCP instruction, on 

SYS1.LOGREC from area pointed to by 

register 1. 

Deyueues SYS1.LOGREC and returns to 

caller (instruction following SVC 76). 


MAKEREC 


IPLEOD 


REISSUE 


REPLYOK 


written. 
0 EOD record processing STATUP reason code and subsystem ID code fields 
4 EREP record processing. in IPL record. 
8 IPL record processing Adds system environmental information to com- CONSTHDR 
12(X‘0C’) Add date and time values to plete record. Prepares to have record written on PREPARE 


CONSTHDR 


PREPARE 


DEMFROUT 


WRTSTAT 
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Recording Diagram 3.1 SVC 76 Recording (NPDA Processing) (Part 1 of 2) 


From: 
SVC 76 
Diagram 3 


Input Processing 





Register O 1 Test if NPDA is active. 


Two's Complement 
Record Size 


No 


To step 6 MO3 


Register 1 


2 Test if NPDA is available. 
Available Not Available 


To step 6 MO3 


1F BDCBOO 


NPDA extension 





a 
ee 3 Build parameter list and 


place address in register 1. 


4 Call NPDA SVC 76 processing 
module (BNJSVC76). 


Return to 
step 6 MO3 





Output 


Register 1 


A Parameter List 
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Recording Diagram 3.1. SVC 76 Recording (NPDA Processing) (Part 2 of 2) 


The NPDA subroutine will get control only 
1GCOOO7F | |IGCOOO7F INPDAROUT 





when register O is negative. 










1 Addressability to IFBDCBOO to get 
the NPDA extension is established, and 
the ‘NPDA active’ flag is tested. If not 
active, control is returned to SVC 76 

processing. 


If the NPDA SVC 76 processing 
module is not available (the 
NPDA module address has been 
set to X‘ 0’), return to SVC 76 
processing. 























Otherwise, build a parameter list 
for NPDA and place its address 
in register 1. 











Issue a branch and link to NPDA 
SVC 76. 











Upon return from NPDA, control 
is returned to SVC 76 for normal 
processing. 


CONTINUE 
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Recording Diagram 4. SVC 91 Recording (Part 1 of 2) 


Input 


Register 0 


UCB in Two's 


Complement 


For 3420 Devices: 


SVRB 
Extended 
Work Area 


ae Processing 


e DDR Swap 
e 1/0 Supervisor 
(via CLOSE/EOV request 
or EOD commands) 
e Master Scheduler 
(for deallocation conditions) 
e SVC 76 Diagram 3 








SVC 91 Record Processing 


1 Tests UCB to determine device 
type: 


Buffered Log IBM 3420 


Device Tape Device 





Output 


Register 0 


Two's Complement 
Record Size 


Register | 


and 


















= Formats 
long OBR For 3420 Devices: 
For Buffered Log Device: record, Long OBR 





Record 
Data in 


Device's 
Buffered 
Log 


or 


For Buffered Log DASD: 





MDR 
Record 





Register 0 


Two's Complement 
Record Size 23s Issues SVC 76 to write record 









on SYS1,LOGREC, == 
Register | 
Ve) 
Exits To: Calling Routine For svc 76 
Recording 
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Recording Diagram 4. SVC 91 Recording (Part 2 of 2) 


Explanation Module CSECT Label Explanation Module CSECT | Label 


SVC 91 documents demounts (CLOSE/EOV 
requests, DDR swaps, deallocation conditions, 
and EOD command) by performing the 
following functions: 


e Formatting long OBR records for the 
IBM 3420 tape devices. 





@ Formatting MDR records for buffered 
log device. 


1 Tests the UCB to determine the device type.| 1GCOQ009A | 1GCO009A | BEGIN 


2 For IBM 3420 devices: Formats date, | OBR 
time, device type, CPU ID, release | 
number, device number information, 
and other device-dependent data | 
into a long OBR record. 





For buffered log device: PART2 


@ Issues EXCP instruction to obtain device- 
dependent information in buffered log. 














Mass Storage Control (MSC) passes the ) 
SSID of the current lower device in the 
Mass Storage System (MSS). 





e Formats buffered log information and 
standard record header information (such | 
as date, time, device number, release 
number, and CPU ID) into an MDR 
record. 





3 Puts long OBR record size in two's comple- 
ment in register 0 and record address in 
register 1. Issues SVC 76 to write the 
record on SYST.LOGREC. 


or 


A215 





B340 





Puts MDR record size in two's complement 
in register O and record address in register 
1. Issues SVC 76 to write the record on 
SYST.LOGREC. 


The MSC passes the SSID of the current 
device until an SSID of FFFF is passed, 
which tells SVC 91 to terminate looping 
read function. 


Control returns to calling routine. 
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Program Organization 
The Program Organization section describes the program organization (object modules) of the system 
recording routines. It contains the following information: 


@ Record processing overview (Recording Figure III-4) — which shows the calling sequences used by the 
various recording routines to format and write the various types of records onto SYS1.LOGREC. 


@ Module descriptions — which describe the logic of each system recording module. 


The module descriptions provide direct references to the module and label directories in this part of the 
publication and to the object module names in the program listings. 
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Y 
Formats records describing: 
' ABEND (SVC 13), invalid SVC, pressed 
supervisor 4 restart key, program checks, and software 
Recording Software Records fe recovery attempts for hard machine failures. 
Calling F ieavrreT | IGCOOO7F « 
AVTRER IEAVTRET 
ae 
sul Receives ia ae NVrites 
sae rican Contro!. 4 records on 
records, queues and 
prepares SYS1.LOGREC. 
records. 
ae) 
Supervisor Records channel failures that do not 
Recording Subchannel Logout Records on cause system termination. 
Handler Supervisor SVC 76 
(IOSRSLH) Queues Receives Asynchron= Wie tpee 
Formats records control ously ce- aitiesen 
records, for queues and ee 
; SYS1.LOGREC. 
recording prepares 
records, 
Recording CRW Records » 




























































CRW 1/0 1GC0007F * 
Processor Supervisor 
(lOSRACRW) Queues Receives Asynchron= Writes 
Pormat records control, ously de= records on 
records. for queues ond SYS1.LOGREC. 
recording. prepares 


records. 


Records paging | © errors; permanent channel and device 
Recording Channel Outboard Records failures; statistical counter values; temporary | © failures. 







































IGEOO25F 1/0 iGCOOO7F* 
Formats Queves Receives Asynchron- Writes 
records. records control ously de- decarde an 

for queves and SYS1.LOGREC, 
recording. prepares 
recards, 


Records data for buffered log devices which describes 
hie 


buffer overflow or device failures. 


Recording Miscellaneous Data Records 






MDR 













(GE0025F 
OF 
IGEO125F * 


Formats 


TEAVTRER 


Queues 


I/O 1GC0007F* 
pee SVC 76 























Receives Asynchron- Writes 
records. records control, ously de- reeordson 
for queues and SYS1.LOGREC. 
recording prepares 


records, 


Records data describing buffer overflow or device failures from 
IBM 3704 and 3705 buffered log devices and device failures 
Recording Miscellaneous Data Records from TP devices connected to an IBM 3704 or 3705 device. 
















170 


Supervisor 






1GCOOO7F* 



























Formats Queues Receives Asynchron= Writes 

records. records control. ously de- records on 
for queues and SYS1,LOGREC. 
recording. prepare. 


records. 


Formats records describing missing channel 
Recording MIHiRecords and device end interrupts. 


















IOSRMIHL esas 


Formats 
records, 


IEAVTRER ff 


Queues 
records 


Control 
Program 


Receives 


IEAVTRET 


Asynchron= Writes 
contro! ously de- records on 
for queues and SYS1 LOGREC, 
recording. prepares 

records. 



















* Described in this publication. 


Recording Figure III-4. Record Processing Overview (Part 1 of 3 ) 
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Machine Check . 
Interrupt Records soft machine checks and correctable 
2 Recording Machine Check Records 


hard machine checks. 




















Handler 


Formats 


Control 
Progrom 


Receives 


IEAVTRER 


|GCO007F * 


IEAVTRET 





Queves 




























Asynchron- Writes 
records. records control. ously de=- records on 
for queues and SYS1.LOGREC. 
recording. alsa 


records 


Records uncorrectable hard machine checks, 
Recording Machine Check Records places system in disabled wait state. 


Handler Program 
Formats Writes 


records. records on 


SYS1.LOGREC. 





MCH 








%* Described in this 
publication. 














Recording Figure III-4. Record Processing Overview (Part 2 of 3) 


Program Organization 


III-29 
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| 
Master J 
Scheduler Formats records describing swaps between direct access, 


Recording DDR Records magnetic tape, and unit record devices. 














IEAVTRER 







IGFDRO 














IEAVTRET 


Prog Cry SVC 76 * 













Formats Queues Receives Asynchron- Writes 
records. records control. ously de- recordecon 
for 
queues and SYS1.LOGREC. 





recording. prepares 


records, 






Recording IPL and EOD Records Formats and writes IPL and EOD records. 
Scheduler 


Recording Channel Outboard Records 


SVC 76) * Scheduler 


Formats and 
writes records 
on 
SYS1 LOGREC 










|GCO007F 
SVC 76) * 


Formats and 










writes records 
on 
SYS1 LOGREC 







Formats and writes EOD statistics for all but 
buffered log DASD and IBM 3420 type devices. 









For IBM 3420 type devices: 
Formats records describing demounts (EOD command, ) 


Recording Channel Outboard Records CLOSE “EOV requests, DDR swaps, and deallocation conditions). 







































|GCO009A |GC0007F 
SVC 91)* SVC 76)* Routine 
records. records on 
SYS1 LOGREC, 
Recording Miscellaneous Records Formats records describing demounts 
(EOD command, CLOSE/EOV requests, 
IGCO009A 1GC0007F Calling and demounts by DFDSS program product 
SVC 91)* SVC 76)* Routine on buffered log devices with removable 
records. records on 
SYS1 LOGREC. 


“ am _ 
For buffered log devices: 
DDR swaps, and deallocation conditions), 
i S. 
Formats Writes disk pack 
* Described in this publication. 





Recording Figure III-4. Record Processing Overview (Part 3 of 3) 
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Module Descriptions 


1GC0007F — SYS1.LOGREC Recorder (IFBSVC76) 
Entry From: Routine issuing SVC 76 to entry point IGCOOO7F. 
Registers at Entry: 
RO -- Two's complement of number of bytes to be recorded onto SYS1.LOGREC. 
or 
Positive input parameter value. 


R1 -- ft record to be written onto SYS1.LOGREC. 
R5 -- tT SVRB. 


Operation: This module is divided into five major processing sections. 


SYS1.LOGREC Recording (WRTREC) 
Tests register O for a positive value. 


If negative, branches to NPDA processing (NPDAROUT). Upon return from the NPDA routine, issues 
EXCP which writes a record on the SYS1.LOGREC data set by: 


@ Reading a copy of the SYS1.LOGREC header record into the 360 byte work area in subpool 245. 
e Using the header information to locate the necessary space on SYS1.LOGREC for the record. 

e Constructing the CCWs to write the record in the work area. 

e Issuing the EXCP to write the record on SYS1.LOGREC. 


e@ Updating the header record to show the address of the last record entry and how much unused space 
remains on SYS1.LOGREC. 


@ Writing the header record back onto the SYS!.LOGREC data set. 


If positive, branches to the statistical recording section of SVC 76. 


Module Descriptions __ III-31 
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Statistical Recording (STATUP) 


Tests the validity of the input parameter in register 0. If invalid, exits to the calling routine. 

If the input value was zero or four: 

@ Builds a short OBR record for each non-zero statistical counter. 

@ Resets each non-zero statistical counter to zero. 

@ Branches to the SYSI.LOGREC recording section of SVC 76 to write each record on SYS1.LOGREC. 


@ Issues SVC 91 for each buffered log DASD to create an MDR record or for each IBM 3420 tape device 
to create a long OBR record. 


@ Branches, when all statistical recording is completed, to the IPL/EOD recording section of SVC 76. 
If the input value was eight, branches to the IPL/EOD recording section of SVC 76. 
If the input value was twelve (X‘OC’): 


@ Sets a switch indicating that the SYS!1.LOGREC time stamp record is to be updated with new data and 
time values. 


@ Branches to the IPL/EOD recording section of SVC 76. 


IPL/EOD Recording (IPLEOD) 


III-32 


If the input value in register O was zero, builds an EOD record containing the date. time, and system 
identification. 


If the input value in register O was eight, builds an IPL record by: 
@ Adding the date, time, and system identification to the record header. 


@ Leaving, if the RDE option is not specified at system generation, the reason code and subsystem ID 
code fields in the IPL record blank. 


Note: If the RDE option is specified (determined by issuing a BLDL to check the system for the RDE 
option), issues a WIOR message to obtain an IPL reason code and a subsystem ID coce for the [PL record. 


If the input value in register O was twelve, adds new date and time values to the SYS1.LOGREC time 
stamp record. 


SYS1.LOGREC Error Recording Logic 
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SYS1.LOGREC Message Recording (MESS) 


Accesses and converts the time into EBCDIC as part of the message. Uses the message code value in register 
12 to index a branch table to issue the appropriate WTO message. Sets the return code in register 15 and 
returns control to the calling routine. Branch table subroutines are: 


Code Subroutine Message Text Return Code 
00 ERROR1M SYS1.LOGREC area is full. 12 (X‘0C’) 
04 ERROR2M SYS1.LOGREC format error. 16 (X‘10’) 
08 ERROR4M SYS1.LOGREC I/O access error. 16 (X‘10’) 
Oc MSGEWM SYS1.LOGREC near full. QO (X‘00') 


Note: When a permanent I/O error (code ‘08’) or invalid header record (code ‘04’) is detected while 
processing, no further recording is attempted. Issues appropriate WTO warning message and sets appropriate 
return code. When an end of data set condition (code ‘00’) is first detected, the LOGREC full message is 
issued, via the WTO. Subsequently, every 30th end of data set condition results in the LOGREC full 
message being issued. All LOGREC recording requests are lost until the data set is reinitialized or cleared. 


NPDA Processing (NPDAROUT) 


Sets up addressability to the NPDA extension in IFBDCBOO CSECT of the nucleus. 


Tests if NPDA is available (NPDA is not available if the NPDA module address in the DCB is zero). 
If NPDA is not available, control is returned to normal SVC 76 processing. 


If the NPDA module address in the DCB is not zero, an NPDA parameter list is built and the NPDA 
SVC 76 processing module is called. 


Data Areas Defined: 360 byte work area in subpool 245. 


Data Areas Referenced: CVT, and NPDA extension in IFBDCBOOQ. 
Data Areas Updated: None. 


Routines Called: None. 

Size: 3496 bytes. 

Exit: Returns to calling routine (instruction following SVC 76). 
Registers at Exit: 


R15 -- return codes: 
00 Normal exit. 
08 Storage not available (no recording attempted). 
OC No space available (no recording attempt). 
10 Permanent |/O error while attempting to write record on SYS1.LOGREC. 
or 
Format error in SYS1.LOGREC header record. 
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IGCO009A — 3420/DASD Statistical Recorder S) 


Entry From: 


@ Routine issuing SVC 91 to entry point [GCOOO9A to format and record a long OBR record describing 
a 3420 demount (DDR swap. EOD command. CLOSE/EOV requests, and deallocation conditions). 


® Routine issuing SVC 91 to entry point IGCOOO9A to format and record an MDR record describing: 


— Demounts (EOD command, CLOSE/EOV requests, and deallocation conditions) for DASD with 
buffered logs, such as the IBM 2305. 3330. 3330 MOD 11, 3850 and 3380 devices. 


Or 


— Demounts by the DFDSS program product between the disk drives on DASD having buffered 
logs and removable disk packs, such as the IBM 3330 MOD 11 and 3340 devices. 


Registers at Entry: 


RO -- ft DCB when SVC 91 is called by CLOSE/EOV. 


or 
t UCB in two’s complement when SVC 91 is called by DDR, deallocation, DFDSS or SVC 76. 
R1  -- EQD flag. 
R3 -- tf CVT. 
R4 -- 1 TCB. 
R5 -- *SVRB. 


R14 -- return address. 


Operation: This module, when invoked, performs one of two major processing functions: J 


3420 Recording (BEGIN) 

Locates the [BM 3420 device involved in a demount operation. Uses the specific environmental and 
Statistical information describing that unit to format a long OBR record. Issues SVC 76 to write the record 
on SYSI.LOGREC,. 


Buffered Log Recording (PART2) 


Determines the device involved in the demount operation and locates its record buffer. Builds CCWs to read 
the data in the buffer and puts them in the IOB. Issues EXCP to read the data into a GETMAIN work area. 


Formats the information into an MDR record and issues SVC 76 to write the record on SYS1.LOGREC. 
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Data Areas Defined: Long OBR record, MDR record. 
Data Areas Referenced: Device statistics table, long OBR record, MDR record. UCB. 
Data Areas Updated: Device statistics table, long OBR record, MDR record, UCB. 
Routines Called: SVC 76. 
Size: 2932 bytes. 
Exit: Returns to calling routine (instruction following SVC 91). 
Registers at Exit: 
R15 -- return codes: 
00 MDR record not written onto SYS1.LOGREC. 


01 Device not ready. 
04 No storage available. 


IGEO025F — OBR/MDR Recorder 
Entry From: 


@ Anerror recovery procedure (ERP) to entry point OBRSTART to format and request recording for an 
OBR record. 


@ A device-dependent ERP to entry point OBRSTART to format and request recording for an MDR 
record for: 


— Device failures on buffered log devices. 
or 


— Buffer log overflow on buffered log devices. 
Registers at Entry: Ri -- tf IOSB. 
Operation: Tests EWA switch EWAFLG2. If on, calls IGEO125F. Tests EWA (ERP work area) switch, 


EWAFLG2, and performs one of two major processing functions, If switch is on, does MDR recording; 
if off, does OBR recording. 
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OBR Recording ) 


Issues GETMAIN to obtain work area storage and constructs an OBR record according to the type of 
condition detected by the ERP: 


TCAM/VTAM permanent error: Builds long OBR record with environmental and statistical data. 
TCAM/VTAM counter overflow or EOD: Builds long OBR record with statistical data. 
Permanent or temporary I/O error: Builds long OBR record. 

Counter overflow: Builds long or short OBR record. 


Invokes the recording request routine which queues the OBR record onto the asynchronous output queue 
and posts the asynchronous recording task. 


Scans the asynchronous OBR queue for any paging I/O errors that were put on the queue by the DASD ERP 
(IECVDERP) and formats a long OBR record for each error on that queue. Then, invokes the recording 
request routine which queues the OBR record onto the asynchronous output queue and posts the asynchro- 
nous recording task. 


Note: The recording task does the actual recording by asynchronously scanning this output queue and 
issuing SVC 76 to write any records on this queue to SYSI.LOGREC. 


MDR Recording 
Locates the error data in the device’s record buffer. Formats the data depending upon the device: 


@ For all buffered log devices except the IBM 3270 (BTAM-supported) devices, formats the 3 
MDR record in the device’s record buffer. 


e@ For the IBM 3270 (BTAM-supported) devices, formats the MDR record in the GETMAIN 
area because the record heading is not a standard 24 bytes. Formatting is done in two steps: 
(1) moves the first six bytes of the record to the work area to update the header area to 24 bytes, and 
(2) adds the remaining device-dependent information to complete the record. 


After formatting the record, places the following exit information in the device’s record buffer: 


@ ‘TPR’ in EBCDIC in the first three bytes. (This information is omitted if the record was not recorded 
successfully.) 


@ Success symbol in the fourth byte: 
00 Successful recording. 
OF Size of header record field is 24 bytes or less (unsuccessful recording). 
FF Unsuccessful recording. 


@ Places XCTL load name value from device’s record buffer in register 13. 


Invokes the recording request routine which queues the MDR record onto the asynchronous output queue 
and posts the asynchronous recording task. Exits. 
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Notes: 


@ XCTL load name comes from the third and fourth bytes of the device’s record buffer. 


e@ Buffered log devices (devices attached to a control unit with a buffer for recording or logging device- 
dependent, status and sense information) are listed in byte four of the MDR record format. 


@ If the device-dependent ERP does not define a device failure to be recorded as an MDR record, the 
ERP causes the failure to be recorded as an OBR record. 


Data Areas Defined: 328 byte work area in subpool 255. 


Data Areas Referenced: ASCB, asynchronous OBR queue, device statistics table, EWA, IOSB, long OBR 
record, MDR record, short OBR record, UCBs. 


Data Areas Updated: Asynchronous OBR queue, device statistics table, long OBR record, MDR record, 
short OBR record, 3211 UCBERCNT. 


Routines Called: ESTAE, GETMAIN. 
Size: 2200 bytes. 


Exit: 
From OBR recording section: 


@ Returns to supervisor when value in register 13 is zero. 
or 


@ Returns to DDR if error is permanent and DDR is in system or to TCAM ERP for TCAM EOD 


condition; loads binary equivalent of module name into register 13 and branches to XCTL routine 
JECXTLER. 


From MDR recording section: 


@ Returns to supervisor when value in register 13 is zero, 
or 


® Loads binary equivalent of module name into register 13 and branches to XCTL routine IECXTLER. 


Registers at Exit: 
When returning to supervisor: 


R13 -- t 1OSB. 


When returning to IEXCTLER: 


R13 -- XCTL load name value. 
R14 -- fT IEXCTLER. 
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IGEO125F -OBR/MDR Recorder (New Interface) 
Entry From: 
@ IGE0025F to entry point IGEO125F to format and request recording for an OBR or an MDR record. 
Registers at Entry: Ri--t IOSB. 


Operation: Tests EWA (ERP work area) switch, EWAFLG2, and performs one of two major processing 
functions. If switch is on, does MDR recording; if off, does OBR recording. 


OBR Recording 


Issues GETMAIN to obtain work area storage and constructs an OBR record according to the type of 
condition detected by the ERP: 


e@e RCTRECSH flag off: Builds long OBR record. 
@ RCTRECSH flag on: Builds short OBR record. 


Invokes the recording request routine which queues the OBR record onto the asynchronous output queue 
and posts the asynchronous recording task. 


Scans the asynchronous OBR queue for any paging I/O errors that were put on the queue by the DASD ERP 
(IECVDERP) and formats a long OBR record for each error on that queue. Then, invokes the recording 


request routine which queues the OBR record onto the asynchronous output queue and posts the asynchro- 
nous recording task. 


Note: The recording task does the actual recording by asynchronously scanning this output queue and 
issuing SVC 76 to write any records on this queue to SYS].LOGREC. 


MDR Recording 
Locates the error data in the caller’s build area. Formats the data in the GETMAIN area. 
e@ Places XCTL load name value from device’s record buffer in register 13. 


Invokes the recording request routine which queues the MDR record onto the asynchronous output queue 
and posts the asynchronous recording task. Exits. 


Notes: 
@ XCTL load name comes from the RCT. 


e Buffered log devices (devices attached to a control unit with a buffer for recording or logging 
device-dependent, status and sense information) are listed in byte four of the MDR record format. 


e If the device-dependent ERP does not define a device failure to be recorded as an MDR record, 
the ERP causes the failure to be recorded as an OBR record. 
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Data Areas Defined: Work Area in subpool 255 = 264 bytes plus length of record. 


Data Areas Referenced: ASCB, CVT, SRB, IOC, PSA, asynchronous OBR queue, device statistics 
table, EWA, IOSB, long OBR record, MDR record, short OBR record, UCBs. 


Data Areas Updated: Asynchronous OBR queue, device statistics table, long OBR record, MDR 
record, short OBR record. 


Routines Called: GETMAIN (SVC120), ESTAE (SVC60), TIME (SVC11), IEAVTRER, SETLOCK, 
FREEMAIN (SVC120), IGEOQ660A. 


Size: 2476 bytes. 
Exit: 


e Returns to supervisor when XCTL and DDR are not requested (RCTRECDR and RCTXCTLX 
are both off). 


or 
e Returns to DDR if requested (RCTRECDR is on). 


e If XCTL is requested (RCTXCTLX is on), loads the binary equivalent of the module name into 
register 13 and branches to XCTL routine (IECXTLER). 


Registers at Exit: 
When returning to supervisor: 


R13 -- TIOSB. 
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Directory 


The Directory section provides the cross-reference lists necessary to quickly identify important names 
in the program listings and in the other sections of this part of the publication. 


This section contains two types of directories: 


Module directory — a list of all the modules involved in SYS1.LOGREC record entry recording. The list 
contains: 


@ The distribution library (DLIB) or microfiche (fiche) name. 

@ The module name and the module name alias(es) in the appropriate system library. 
e@ A brief description of the function of each module. 

@ The CSECT, entry point, and load module names. 


The list is organized alphamerically by system library and recording group; then alphamerically by module 
name within each group. 


Label Directory — a list of the major labels in the system recording modules. The list contains: 
@ The module where the label is located. 
e@ A brief description of the functions of the code associated with the label. 


@ The method of operation (MO) diagrams that contain or indicate the functions related to that label. 


The list is organized alphamerically by module name and then alphamerically by label name within each 
module. 
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Module Directory 


DLIB Entry 
Fiche Point 
OBR/MDR Recording Module 
IFBOBROO OBRSTART 
IFBOBRO1 IGEQ125F 
SVC 76 

IFBSVC76 1GCOQ007F 
SVC 91 

{GCOO0SA |1GCOO0SA 
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Load 
Module 


IGEO025F 
IGE0O125F 


1GC0007F 


IGCOOOSA 


CSECT 


IGEOO25F 
1GE0O125F 


1GCOQ007F 


1GCO009A 


SYS1.LPALIB 


Name 


1GEQ025F 
1GEO125F 


|GCO007F 


IGCOOO9A 


Alias 


IGE0625F 


Function 


OBR/MDR recorder. 
OBR/MDR recorder. 


SYS1,LOGREC recorder. 


3420/DASD statistical 
recorder. 


C 


Label Directory 


Label 


MO(s) 


In Module |GC0007F 


CONSTHDR 


ERR3B 


EWMSG 


EXIT 


GETIME 
INDEX 
INFORM 


IPLEOD 
ISNEWDEV 


LOOP3 


MAKEREC 
NCLROPT 

NEWSTAT 
NOT2314 


PREPARE 
RECHECK1 
RECHECK2 
RECSET 


REISSUE 
REPLYOK 
RTRN 


STATLKUP 


3 


N/A 
N/A 


Oo WW WwW 


OW WH WwW 


WO Ww 
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Description 


Adds header data for either EOD or IPL record. Adds record type and 
length information to IPL record. 


Issues EXCP macro to read and write records to SYS1.LOGREC including 
header record. Checks completion code in TPRECB. 


Checks whether early warning message has been issued. Checks whether 
90% of allocated tracks for SYS1.LOGREC have been used. 


Frees work area storage, sets return address, and returns to calling routine 
at instruction following SVC 76. 


Obtains and edits time for WTO messages. 
WTO message branch table. 


Issues WTO message indicating that WTOR message reply was invalid, and 
reissues IPL WTOR. 


Issues BLDL macro to check for RDE option in system. 


Checks online status of IBM 2305, 3330, 3340, 3375, 3380, 3420 and 3850 
series of devices. If online, passes UCB address in two’s complement in 
register 0 to SVC 91. Issues SVC 91. 


Obtains address of entry in device statistics table. Checks for table entries 
having more than 10 bytes. 


Constructs EOD record. 
Adds counter overflow information to short OBR record. 
Processes each entry in device statistics table. 


Tests UCBs for IBM 3420 type magnetic tape devices. If in system, 
puts a value (51) indicating this in register 1 before issuing SVC 91. 


Puts EOD record type and length into record area. 
Checks validity of reason code reply portion of IPL WTOR. 
Checks validity of subsystem reply portion of IPL WTOR. 


Puts short OBR record address in register 1. Puts two’s complement of 
record length in register 0. Branches to WRTSTAT to write record onto 
SYS1.LOGREC. 


Issues WTOR message for IPL record information. 
Puts IPL information from IPL WTOR into record area. 


Tests for error conditions, resets short OBR processing switch, branches to 
exit for issuing WTO message, and dequeues. 


Tests for valid UCB address and end of UCB list. Gets pointer from UCB 
to device’s entry in device statistics table. 
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Description 


In Module 1GC0007F (Continued) 


STATUP 3 


STGAVAIL 3 


WRTREC 3 


WRTSTAT 3 


In Module |GCO009A 


A150 4 
A215 4 
BEGIN 4 
B100 4 
B200 4 
B340 4 
IGCOO09A 4 
OBR 4 
PART2 4 


In Module IGEOQO25F 
ATCMREC 2 


DIRENTRY 2 


DIRCHK 2 
EXIT1 2 
FULLREC 2 
INITHDR 2 
LOOP2 2 


Tests positive input value from register 0 to determine type of recording to 
be done (zero — EOD and statistical, four — statistical, eight — IPL, 12 — 
update SYS1.LOGREC time stamp record). 


Clears work area storage. Tests for short OBR entry before issuing enqueue. 
Fetches SYS1.LOGREC header record using an internal link to a channel 
program. Obtains buffer and builds CCWs to write record on SYS1.LOGREC. 


Saves address of record to be recorded. Issues GETMAIN to obtain work 
area storage. Checks GETMAIN for successful completion. If GETMAIN 
was unsuccessful, sets condition code (x‘08’) in register 15. 


Resolves address constants and other addresses not resolved by loader. 


Issues GETMAIN macro to obtain 160 byte work area. 


Adds sense data to record. Puts two’s complement of record size in register 
0. Puts record address in register 1. Issues SVC 76 to write long OBR 
record on SYS1.LOGREC. 


Puts UCB address in register 10, DEB address in register 11, and DCB address 
in register 13. 

Issues GETMAIN macro to obtain storage for work area. Builds CCWs in 
1OB for reading record buffer of a buffered log DASD. 

Issues EXCP SVC to read data from a buffered log DASD. Adds standard 
header information for MDR record. 


Converts record size in register 0 into two’s complement. Issues SVC 76 to 
write MDR record onto SYS1.LOGREC. Issues FREEMAIN macro to free 
work area storage. 


Establishes addressability and saves passed value in register 1 in storage. 
Tests register O for a negative value; if so, makes it positive. Tests UCB for 
disk processing; if so, branches to PART 2. 


Adds standard header information for OBR record. 


Establishes addressability and determines device type. 


Sets VTAM device switch. Tests EWA for VTAM device EOD or VTAM 
overflow condition and builds a long OBR record if condition NOT=YES. 


Uses [OSB and EWA information to format along OBR record for each 
paging |/O error queued on asynchronous OBR queue. 


Obtains pointers to ERP/WTO queue, IOSB, and EWA. Sets switch to 
indicate that DASD ERP (lIECVDERP) has queued any paging I/O error 
information on asynchronous OBR queue. 


Uses address in register 14 to branch to SCTL routine (IECXTLER)}. 


Puts ‘PAGE ERR’ jobname in long OBR record if recording is for any 
paging I/O errors on asynchronous OBR queue. 


Formats error data from record buffer into an MDR record. 


Checks statistic counters for specific devices (UCBs). Checks for variable 
length entries in device statistics table. 


ItI-44 SYS1.LOGREC Error Recording Logic 


This document contains restricted materials of IBM. LY28-1187-0 ©Copyright IBM Corp. 1982 


Label 


MO(s) 


Description 


In Module IGEQO25F (Continued) 


NOMAIN 2 Frees |OSB pointer and returns control to supervisor. 

NOT2314 2 Puts address of device statistics table from CVT in register 5. 

SAVEADR 2 Saves record buffer address in register 11. 

SENSE 2 Adds sense information to record. 

SETADR 2 Invokes recording request routine to move OBR record onto asynchronous 
output queue. 

SETIME 2 Adds time and date information to record. Invokes recording request 
routine to move MDR record onto asynchronous output queue. Tests 
result of write operation. 

SVCPRE Calculates OBR record size in register 0. 

TAMOFL 2 Completes short OBR record for TCAM/VTAM EOD or counter overflow 
condition. 

TCREC 2 Sets TCAM device switch. Tests EWA for TCAM device EOD or TCAM 
counter overflow condition and builds a long OBR record. 

TERM1 2 Puts name of XCTL module (IECXTLER) in register 13 or, if register 13 is 
zero, returns controls to supervisor. 

TSTPERM 2 Tests switches to determine type of OBR record to create: permanent error 


condition — long OBR record, counter overflow condition — short OBR 
record, variable length statistic counters — long OBR record. If none of 
these switches are on, sets temporary error switch to create a long OBR 
record. 


In Module IGE0125F 


FREEBLDA 2.1 Frees the caller’s build area using the length in the RCT and the address 


determined from the RCT. 
FREECORE 2.1 
FREEIOSB 2.1 


Frees the recorder’s build area and automatic storage at the end of processing. 


Obtains a local lock, calls the core manager to free the |OSB, releases the 


local lock. 

GETFAIL 2.1 If the GETMAIN for OBR’s automatic data fails then this exit is taken. It 
XCTLs if that was requested, otherwise it exits normally. 

HDRINFO 2.1 Fills in record independent information in the record: class/source, system/ 


release level, record switches, time, date CPUID, reserved bytes in the header. 
Some of this data is obtained from the caller’s build area and some is obtained 
from the system. 


LONGOBR 2.1 Fills in information that is specifically needed for long OBR records: JOBID, 
CCW, CSW, device dependent data, SDR counters, sense bytes, |/O retry 


count, device number, device type. 


Fills in MDR specific information: BUFRECID, BUFSUBID, and the device 
buffer. 


MDR1 2.1 
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Description 


In Module |GE0125F (Continued) 


SETADR 2.1 


SETSDR 2.1 


SHORTOBR 2.1 
YESGET 2.1 


Sets up for and issues the RECORD macro (RO = length of record, R1 = addr 
of record). 


Places the SDR counters into the record and clears the statistics table entry 
for the failing device. 
Fills in short OBR specific data: device type, device number. 


If GETMAINS for the recorder are successful, YESGET sets the ESTAE exit 
and calls the proper formatting procedure (LONGOBR, SHORTOBR, MDR’1). 
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Data Areas 


The information in the data areas can assist in interpreting storage dumps and in determining the program 
and system status at the time of a failure. 


Consult System Programming Library: SYS1.LOGREC Error Recording for the detailed format of the 
major system recording data areas that are listed below. Consult Debugging Guide, Volume 5, for the 
detailed format of the SDWA that is part of the software record. 


The following major data areas are used by the system recording routines: 


Channel record word (CRW) record. 
Dynamic device reconfiguration (DDR) record. 
EOD record. 

IPL record. 

Machine check (MCH) record. 
Miscellaneous data (MDR) record. 

Missing interruption handler (MIH) record. 
Outboard (OBR) record — long form. 
Outboard (OBR) record — short form. 
Software record. 

Subchannel logout handler (SLH) record. 


Data Areas III-47 


11-48 





This document contains restricted materials of IBM. LY28-1187-0 ©Copyright IBM Corp. 1982 


SYS1.LOGREC Error Recording Logic 


Diagnostic Aids 


This document contains restricted materials of IBM. LY28-1187-0 ©Copyright IBM Corp. 1982 


The Diagnostic Aids section provides cross-references between the diagnostic information in this section to 
the related sections in this part of the publication and to the program or microfiche listings. 


This section contains the following lists of information about the system recording modules: 


@ Messages — a summary of the messages, their message IDs, issuing modules, modules with the message 


text, detecting modules, and the related method of operation (MO) diagrams. 


@ Return codes — a summary of the return codes, their meanings, and the related MO diagrams. All 
return codes are in register 15. 


e System completion codes — the system recording modules do not issue any system completion 
codes. (No list provided.) 


e Wait state codes — None. (No list provided.) 


Recording Messages 


Consult Message Library: System Messages for more details about the recording messages: 


Message ID 
IFBO10D 


IF BO201 
|F BO30! 


IF BO401 


IF BO501 


IF BO60E 


Message Text 


ENTER “IPL REASON 
SUBSYSTEM ID” OR "“U” 


INVALID REPLY TO IFBO10D 


SYS1.LOGREC I/O ACCESS 
ERROR, sens, stat, hh.mm.ss 


SYS1.LOGREC AREA IS FULL, 
hh.mm.ss 


SYS1.LOGREC FORMAT 
ERROR, hh.mm.ss 


SYS1.LOGREC NEAR FULL 


Message 
Text 

and Issuing 
Module 


IGOQ007F 


|GCO007F 
|GC0Q007F 


|GCOQ007F 


|GCO007F 


|GC0O007F 


Detecting 
Module(s) 
|GCO007F 


|GCO007F 
!GC0007F 


|GC0007F 


1GCOQ007F 


IGC0007F 


MO(s) 
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Module 
ICF BDFOO 


|GC0007F 


|IGCOO09A 
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Return 
Code 
(Hex) 


26 
27 


00 
08 
OC 


10 


00 
01 
04 


Meaning 


Successful completion of dump. 
Missing interrupt during I/O clear routine in the appendage, 
program check in the dump routine, or failure to complete 
the dump once the dump routine was entered. 
Normal exit. 
Storage not available (no recording attempted). 
No space on SYS1.LOGREC available 
(no recording attempted). 
Permanent |/O error while attempting to write 
record on SYS1.LOGREC. 
or 
Format error in S¥S1.LOGREC header record. 
MDR record not written onto SYS1.LOGREC. 
Device not ready. 
No storage available. 
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IGEO025F  III-35 microfiche names, module, (see module directory) 
(see also OBR/MDR recorder) MIH record 
IGEO125F  III-38 on SYS1.LOGREC III-47 
(see also OBR/MDR recorder - new interface) MIH recording 
incident records operation diagram III-16 
on SYS1.LOGREC program calling sequences _III-30 
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IPL record system recording routines III-31 
on SYS1.LOGREC 1-3 module directory 
IPL recording IFCDIPOO II-14 
modules involved system recording routines III-42 


IGCO007F III-31 
operating diagram III-20 
program calling sequence III-30 N 
RDE option III-32 NPDA Processor 
input III-22, I-23 
process I[II-22, III-23 


J output [IJ-22, III-23 
JCL parameters, used for controlling program 
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OBR recorder (see OBR/MDR recorder) 


L OBR recording (see also demount recording; end-of-day 
label directory, system recording routines III-43 recording; SVC91) 
library names, module (see module directory) modules involved 
load module names (see module directory) IGCOO07F  III-39 
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MCH record operation I-22, III-23 
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MCH recording OBR/MDR recorder (IGE0025F) 
program calling sequences III-30 description 
MDR record MDR recording __ III-43, III-44 
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MDR recorder (see OBR/MDR recorder) input —_III-20, III-21 
MDR recording labels _III-57, III-58 
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IGCO007F  III-31 3270 MDR record formatting exception _III-44 
IGCO125F ILI-38 operation diagrams (see method of operation diagrams) 
IGE0025F III-35 operator swap (see DDR swap) 
operation diagram IIJI-25 outboard recorder (see OBR/MDR recorder) 
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teleprocessing (TP) recording 
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